Skip to main content

Last Change: 2025-08-27 #dba #JT

Add Cavity sphe_add_cavity

Using the sphe_add_cavity tool, you can add cavities to the generated Spherene structure using a control geometry. This tool creates a smooth inner surface for the cavity. In contrast, if you initialize the envelope with an existing cavity directly, volcano structures will be generated on the inner surface of the cavity.

Spherene with a cavity generating by the tool add_cavity or initial envelop with a cavity.

Spherene with a cavity generated by the tool add_cavity compared to an existing cavity in the envelope mesh.

Usage​

Add a closed or open mesh geometry as a cavity to "push" away the surrounding Spherene structure. Use the front_space checkbox to select which domain or labyrinth to access.

These options appear in a pop-up window for Mac users or in the command line for Windows users. Afterwards, you can access this checkbox in the Spherene_Inspector window when selecting a cavities geometry.

Cavity Modifier UI
tip

Select an existing cavity mesh to edit its value using the spherene inspector :

Workflow​

The general workflow of the sphe_add_cavity tool is as follows:

  • Create a mesh representing the desired cavity. The cavity can have an arbitrary geometry. Here, we use a cylindrical mesh as an example of cavity, as shown in the figure below:
Define cavity mesh
  • Click the tool button UI button for add_cavity. In the pop-up window (for Mac users) or command line (for Windows users), you can choose to turn on the attribute front_face. This tells the algorithm which domain or labyrinth to access. Later you can access this attribute in the Spherene Inspector after selecting the cavity mesh.
Define cavity mesh
  • Select the cavity mesh and press Enter.
  • Click the compute button UI button for compute, then select Solid Surface to start the computation.

You can also define a cavity using an open mesh, in this case, the cavity is generated only on the mesh surface.

(a) A cavity defined by an open mesh, and (b) the resulting Spherene structure.

(a) A cavity defined by an open mesh, and (b) the resulting Spherene structure.

You can download this example file here.

Specifications​

  • Multiple cavities can exist in a project
  • Cavity meshes can be inside, intersecting or outside the spherene envelope.
  • Cavity meshes can be closed or open